
Template application "Optika eMedia Filer"

==========================================


The template application "eMedia Filer" creates single-page TIFF images
and an ASCII input file that can be imported into Optikas eMedia Filer.


Folder structure
----------------

* Upon processing of a batch, a folder with the same name as the batch
  is created in the output path specified in the "Output" tab of the
  command "Application Setup" under the "File" menu of Capture Software.

* The input file is also created and placed in the output path (see be-
  low for a full description of the input file). Next, folders for each
  document in the batch are created and placed in the batch folder.

* These folders are named according to the Capture Software document
  number. The TIFF images are placed in the document folders and are
  numbered sequentially across the documents, starting at 0. All docu-
  ment folder and image names are zero filled to 8 characters.


Example
------- 

* "BATCH003" has 2 documents and an output path defined as
  "C:\BATCHES".

* Document 1 has two images, document 2 has 3 images.

* At process time, the folder "BATCH003" will be created and placed in
  "C:\BATCHES".

* In "BATCH0033", two folders - "00000001" and "00000002" - will be cre-
  ated. The images "00000000.TIF" and "00000001.tif" will be placed in
  the folder "00000001", the images "00000002.TIF", "00000003.TIF" and
  "00000004.TIF" will be placed in the folder "00000002".

* Therefore, "BATCH003" with 2 documents (1 and 2), will, at pro-
  cess time, produce the following folder and file structure:

	C:\BATCHES\BATCH003\00000001\00000000.TIF
		       		 ...\00000001.TIF	
			...\00000002\00000002.TIF
				 ...\00000003.TIF
				 ...\00000004.TIF



Input file
----------

* The input file is created at process time and contains the path name
  of every image in the batch as well as any document level index infor-
  mation.

* Each line of the input file represents one TIFF image.

* The first field of each line is a TIFF images full path name and is
  always followed by the "|" character.

* The rest of the line is used to record the values of any index fields
  that were defined for the document that the particular image is part
  of.

* A user-definable field delimiter separates the index fields. The de-
  limiter can be changed on the Optika eMedia Filer setup. To access
  this dialog, open the "Application Setup", select the "Output" tab and
  click the "Setup" button. The delimiter must be defined and can only
  be a single character. The default delimiter is "|". Any index field
  left blank will result in two delimiters being printed right next to
  each other. The final index field is not followed by a delimiter.

* Each line is terminated with a CR (carriage return) - LF (linefeed)
  character.



Input file rules
----------------

* The input file for the above example would be placed in
  "C:\BATCHES". Assuming that each document had two index fields -
  first name, middle initial and number - and that the field delimiter
  was set to "~", the input file would have the following contents:

	C:\BATCHES\BATCH003\00000001\00000000.TIF|Jack~A~123
	C:\BATCHES\BATCH003\00000001\00000001.TIF|Jill~B~222
	C:\BATCHES\BATCH003\00000002\00000002.TIF|Bill~G~334
	C:\BATCHES\BATCH003\00000002\00000003.TIF|Mike~Z~456
	C:\BATCHES\BATCH003\00000002\00000004.TIF|John~I~890

* The name of the input file can be either the current batch name or u-
  ser-defined. To select one or the other, go to the Optika eMedia Filer
  Setup. The default option is to name the input file after the batch.

* If the name of the input file is user-defined, the name can contain a-
  ny character but it must include either one "*" (asterisk) or at least
  one "?" (question mark) and be less than or equal to 8 characters in
  length. The "*" and "?" symbols are treated as wildcard characters
  and are replaced by digits when the actual file is created. When cha-
  racters other than "*" or "?" are used in the name, they must precede
  all wildcards. The digits that replace the wildcards increment across
  batches and thus allow for the unique naming of multiple input files.

* If an asterisk ("*") is used as a wildcard, only one is allowed and
  the input file name will consist of any constant characters plus how-
  ever many digits are required to fill the name to 8 characters.

* If one or more question marks ("?") are used, the input filename will
  consist of any constant characters plus as many digits as there are
  question marks. When using more than one question mark, they must be
  placed adjacent to each other. 

* The input file extension is also user definable and must contain at
  least one, but no more than three, characters. To change the exten-
  sion, go to the Optika eMedia Filer setup. The default extension is
  *.IDX. Any extension can be used, but if using the extension *.DAT
  when the option "Input File Name is Batch Name" is selected, the de-
  fault filename and extension of the Capture Software batch index file
  (a file produced by Capture Software for every batch) may conflict
  and must be changed. This can be done by going to "Application Setup",
  clicking the "Index" tab, selecting the "Batch" tab and changing the
  extension given in the "Path" window.



Valid input file samples
------------------------

Here are some valid examples of a user-defined input filename and the
value its counter will have when the first input file is created. (The
*.TXT extension is now assumed.)

	*		00000001.TXT
	INV*		INV00001.TXT
	CHECK* 		CHECK001.TXT
	?		1.TXT
	???		001.TXT
	INV??		INV01.TXT
	INV????		INV0001.TXT



Invalid input file samples
--------------------------

* Here are some invalid examples of a user-defined input name and the
  reason they are invalid:

	*?		
	Only one type of wildcard can be used.

	*INV		
	Constant characters do not proceed the wildcard character.

	?CHECK		
	Constant characters do not proceed the wildcard character.

	I?N?V
	The constant characters do not precede all wildcard characters.
	The use of the "?" wildcard must be contiguous.

* If the value of the counter in the input file name ever exceeds the
  maximum that can be expressed by the digits in the counter, the user
  will be provided the option to halt processing or to continue pro-
  cessing (thereby possibly overwriting an existing input file when the
  counter resets to 1).
